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Introduction 


Flarum 文档 


本 文档 翻译 自 Flarum 官方 文档 。 
Flarum 是 一 款 现代 、 优 雅 、 和 简洁、 强大 的 论坛 软件 。Flarum 让 在 线 交 流 变 得 更 加 轻松 愉快 。 
开始 阅读 


本 手册 由 Flarum 中 文 社区 翻译 。 


Github 


本 文档 源码 托管 在 : https://github.com/justjavac/flarum-doc 
目录 及 翻译 者 
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Introduction 


o 搜索 
e 翻译 Flarum 
o 介绍 
o 打包 
o 本 地 化 Ojustiavac 
o 升级 


o 分 发 


本 文档 最 后 由 @ttnl 维护 于 2017 年 1 月 22 日 。 


Flarum 是 一 款 专 注 于 简洁 的 ， 自 由 、 开 源 的 论坛 软件 。 通 过 Flarum 您 可 以 轻松 地 为 您 的 网 


站 搭建 一 个 论坛 。 


Flarum 在 GitHub 上 开放 地 开发 。 


目标 


Flarum 是 esoTalk 和 FluxBB 的 共同 继承 者 。 它 的 目标 是 : 


e 快速 、 简 单 。 没有 混乱 ， 没 有 膨胀 ， 没 有 复杂 的 依赖 关系 。Flarum 使 用 PHP 构建 ， 
此 它 很 容易 部 署 。 界 面 使 用 Mithril， 它 是 一 个 高 性 能 JavaScript 框架 。 


e 漂亮 、 响 应 式 。 Flaum 旨 在 以 人 为 本 ， 它 有 着 精心 的 跨 平 台 的 、 开 箱 即 用 的 设计 。 界 面 
布局 使 用 了 LESS， 所 以 主题 风格 只 是 小 事 一 桩 。 


e 强大 、 可 扩展 。 为 了 满足 您 的 社区 需求 ， 您 可 以 定制 、 扩 展 和 集成 Flar um ° Flarum 的 
架构 非常 灵活 ， 同 时 提供 有 全 面 的 API 和 文档 。 


e 自由、 开放。 Flarum 基于 MIT license 发 布 。 


Gd 
HR 
Flarum 目前 处 于 测试 阶段 ， 因 此 不 要 将 它 用 在 生产 环境 中 。 Flarum 的 源码 在 GitHub 。 
查看 开发 进度 的 路 线 图 。 


立即 使 用 Flarum， 可 以 到 下 载 页 面 。 你 需要 一 个 安装 了 PHP 5.5+ 和 MySQL 5.5+ 的 服务 


o 
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核心 团队 


核心 开发 者 
核心 开发 者 
项 目 管理 


e Toby Zerner (GitHub, Twitter) 
e Franz Liedke (GitHub, Twitter) 
e Daniël Klabbers (GitHub, Twitter) 
e Jordanjay29 (GitHub) - 社区 管理 
e Dominion (GitHub) — 国际 化 
e Kulga (GitHub) - 社区 主持 人 
e Digital (GitHub) - 社区 主持 人 
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144 : Ojustjavac Last updated by @ttnl 17/1/20 


感谢 您 帮助 我 们 测试 Flarum。 我 们 很 高 兴 您 能 加 入 我 们 的 团队 ! 我 们 需要 能 够 耐心 地 对 问题 
进行 检查 且 能 清晰 地 对 其 进行 沟通 的 人 。 也 许 你 已 经 知道 ， 优 秀 的 Bug 报告 花费 时 间 和 精 
力 。 如 果 你 没有 意见 ， 那 么 我 们 就 开始 吧 ! 

已 经 发 现 了 Bug ? AAT ! 我 们 愿 闻 其 详 不 过 你 首先 应 该 检查 你 是 否 把 时 间 花 费 在 了 已 
经 知道 的 问题 上 : 





。 搜索 我 们 的 支持 论坛 查看 


请 记 住 ， 漏 洞 报告 的 目标 是 使 我 们 能 轻松 地 重 现 此 漏洞 ， 并 开发 出 对 应 补丁 。 因 此 ， 你 应 该 
提供 尽 可 能 多 的 相关 信息 ， 并 且 用 清晰 且 基 于 事实 的 语言 与 我 们 沟通 。 这 篇 文章 是 关于 如 何 
有 效 报告 漏洞 的 绝 佳 材料 。 


如 需 报 告 漏洞 ， 请 在 Github 上 的 flarum/core 库 中 创建 问题 (issues) 。 在 提交 issues 之 
前 ， 请 搜索 一 下 之 前 的 issues。 


页 献 代 码 


请 参阅 页 献 代 码 。 


译 者 : @ttnl 
Last updated by @ttnl 17/1/20 


FAQ 


什么 时 候 才 能 发 布 Flarum 的 稳定 版 ? 


我 们 也 不 能 保证 什么 时 候 可 以 发 布 
注 我 们 的 开发 进度 。 


因为 中 间 的 变数 太 多 ! 不 过 ， 你 可 以 按照 Roadmap X 





届时 我 能 把 论坛 从 Beta 版 升级 到 稳定 版 么 ? 


可 以 。 然 而 升级 过 程 可 能 会 略微 地 " 弄 脏 你 的 手 "。 我 们 会 尽量 做 到 使 这 一 过 程 足 够 简单 。 


那么 我 能 不 能 在 实际 中 用 Beta 版 呢 ? 


安装 指示 中 反对 这 种 做 法 是 有 原因 的 。 迄 今 Flarum 都 还 不 够 成 熟 ， 亦 存在 着 很 大 的 出 错 的 空 
间 。 你 使 用 的 扩展 可 能 和 更 新 版 的 beta 发 生 泻 当 冲突。 这些 Bug 可 能 造成 内 容 丢 失 或 者 是 大 
量 的 用 户 隐 私 资料 上 曝光。 未 达 最 佳 标准 的 SEO 可 能 损害 你 网 站 的 搜索 引擎 排名 ， 使 得 你 的 网 
站 更 难 吸 引 新 的 用 户 。 现 在 的 用 户 可 能 对 性 能 问题 或 未 完成 的 功能 表示 不 满 ， 甚 至 离开 你 的 
网 站 。 缺 点 不 一 而 足 。 

你 也 可 以 决定 忽略 这 些 风险 并 安装 Flaurm， 这 上 毕竟 取决 于 你 ...... 但 是 你 需要 注意 如 果 一 旦 
出 现 问 题 ， 处 理 它们 将 会 是 你 的 责任 。 我 们 不 能 保证 能 帮助 你 解决 这 些 问题 。 所 以 牢记 你 将 
处 理 的 是 你 的 网 站 ， 然 后 明智 的 做 出 选择 。 


我 该 怎么 添加 Logo， 链 接 ， 或 者 是 网 站 图 标 
(favicon) ? 


添加 网 站 图 标 只 需 将 适合 的 favicon.ico 添加 到 域名 目录 根部 即 可 。 暂 时 还 没有 简单 的 添加 
Logo 或 者 是 连接 的 方法 ， 但 是 在 最 近 的 新 版 本 beta 中 会 出 现 。 感 谢 你 的 耐心 ! 


我 能 把 Flarum 5 WordPress / Laravel / 其 他 软 
件 整合 么 ? 


那 不 是 很 好 么 ! 现在 它 已 经 是 可 能 的 了 ， 但 是 我 们 希望 会 在 未 来 在 整合 方面 做 更 多 的 工作 。 
如 果 你 是 个 开发 者 ， 那 么 阁 请 参与 这 一 进程 吧 | 


Flarum 会 有 [在 此 插入 功能 ] 4 ? 什么 时 候 ? 为 什 
么 没有 ? 


我 们 自然 希望 Flarum 有 数 不 清 的 功能 和 扩展 ， 但 是 要 事 第 一 。 在 这 之 前 ， 我 们 的 目标 集中 在 
必需 品 和 稳定 性 上 。 查 看 我 们 的 Roadmap 以 关注 我 们 未 来 将 实现 哪些 功能 。 


为 什么 你 们 还 没有 修复 [在 此 插入 问题 ]? 


这 次 的 答案 仍旧 是 “要 事 第 一 "。 如 果 我 们 目前 还 没有 修补 一 个 问题 (或 者 分 配 它 为 一 个 
Milestone) ， 那 是 因为 我 们 正在 其 他 重要 的 事情 上 工作 。 请 耐心 等 待 ; 我 们 会 尽量 在 稳定 版 
前 把 它 完 成 。 如 果 你 很 急 的 话 ， 欢 迎 你 来 参与 修复 ， 对 本 项 目 做 出 贡献 1 HH 


我 能 把 我 的 论坛 迁移 到 Flarum A ? 


可 以 ， 不 过 尚 需 等 待 。 我 们 现在 的 重点 是 让 Flarum 更 加 稳定 ， 并 且 功 能 完备 。 一 旦 我 们 已 有 
将 Flarum 应 用 于 生产 环境 的 信心 ， 我 们 就 会 制作 导入 其 他 论坛 数据 的 工具 ， 比 如 esoTalk > 
FluxBB * phpBB » 等 等 。 


为 什么 我 不 能 排版 我 的 帖子 ? 
Flarum 目前 暂 无 可 视 的 编辑 器 一 一 因为 我 们 在 Beta 版 之 前 还 没有 准备 好 。 请 放心 ， 这 已 被 
纳入 计划 ， 很 快 就 将 在 核心 中 出 现 。 


尽管 现在 还 没有 可 视 编辑 器 ，Flarum 已 支持 Markdown 和 BBcode 语法 。Markdown 是 一 种 
用 于 表示 eed . RAN 基于 结构 化 文档 的 纯 文 本 语法 格式 。 如 果 你 对 Markdown 


毫 不 熟悉 ， 请 看 看 这 速 入 门 以 帮助 你 快速 在 Flarum 上 排版 。 
我 该 怎样 将 Flarum 翻译 成 我 的 语言 ? 


我 们 目前 还 在 为 语言 包 制作 的 过 程 而 工作 。 我 们 希望 您 能 在 万 事 俱 备 前 稍 加 等 待 。 感 谢 你 的 
耐心 1 


译 者 : @ttnl Last updated by @ttnl on 17/1/20 


使 用 Flarum 


添加 语言 
故障 诊断 


使 用 API 


Beta 版 软件 


请 留意 Flarum 正 处 在 Beta 版 软件 阶段 。 这 意味 着 : 





e 它 还 有 很 多 没完 成 的 功能 和 Bug: mE 
e 某 些 时 候 CC TAX NS IC CLEA H ! 


Beta 阶段 关乎 解决 这 些 问 题 并 改善 Flarum。 我 们 正在 努力 使 Flarum 更 好 ， 所 以 我 们 希望 


你 : 


e 不 要 在 生产 环境 中 使 用 它 。 如 果 出 错 了 ， 我 们 可 帮 不 了 你 。 况 且 升 级 到 未 来 的 版 本 可 能 
AME R IE JL © 

e 有 责任 感 地 汇报 Bug。 书 写 差 劲 的 Bug 报告 需要 花 很 多 时 间 处 理 ， 会 扰乱 我 们 添加 新 功 
能 或 者 使 Flarum 更 稳定 的 进程 。 在 你 安装 前 ， 请 阅读 我 们 的 贡献 规则 ， 你 将 了 解 你 注 
册 的 意义 ! 


注意 : 仅 就 0.1.0-beta.3 版 中 ，Flarum 使 用 Composer 管理 依存 关系 和 扩展 。 这 意味 着 
Flarum 没 法 在 没有 SSH (命令 行 ) 连接 的 主机 上 安装 。 我 们 未 来 会 保证 Flarum 能 用 其 
他 的 方法 安装 ， 使 之 可 被 所 有 人 使 用 。 与 此 同时 ， 如 果 现 在 你 希望 运行 Flarum， 你 需要 
寻找 允许 SSH 连接 的 主机 。 


下 为 运行 Flarum 所 需 的 一 些 条 件 。 


e 网 页 服务 器 软件 : Apache (需要 支持 mod_rewrite)，Nginx， 或 者 Lighttpd 

e PHP 5.5+， 需 要 开启 的 扩展 : mbstring, pdo_mysql, openssl, json, gd, dom, fileinfo 
e MySQL 5.5+ 

e SSH (命令 行 ) 连接 


安装 Flarum 


Flarum 使 用 Composer 做 为 管理 依存 和 扩展 的 工具 。 所 以 ， 在 安装 Flarum 之 前 ， 你 需要 在 
你 的 电脑 上 安装 Composer。 然 后 在 Flarum 应 该 安装 的 地 方 运行 此 命令 : 


composer create-project flarum/flarum . --stability=beta 


运行 时 ， 你 就 可 以 为 你 的 服务 器 配置 URL 重 写 了 。 最 后 ， 使 用 浏览 器 访问 你 的 论 


Apache 





Flarum 附带 了 一 个 Apache 的 .htaccess 文件 记得 正确 地 上 传 它 。 如 果 你 在 使 用 共享 空 
间 ， 确 保 你 的 空间 提供 商 开 启 了 mod rewrite 。 你 也 可 能 需要 将 下 述 加 入 到 你 的 Apache 配 
置 中 : 


<Directory "/path/to/your/forum"> 
AllowOverride All 
</Directory> 
Nginx 


添加 下 述 配置 到 你 的 服务 器 配置 块 : 


location / { try files $uri $uri/ /index.php?$query_string; } 
location /api { try_files $uri $uri/ /api.php?$query_string; } 
location /admin { try_files $uri $uri/ /admin.php?$query_string; } 


location /flarum { 
deny all; 
return 404; 


location ~* \.php$ { 
fastcgi_split_path_info %(.+.php)(/.+)$; 
fastcgi pass unix:/var/run/php5-fpm.sock; 
include fastcgi params; 
fastcgi param SCRIPT FILENAME $document root$fastcgi script name; 
fastcgi param HTTP PROXY ""; # Fix for https://httpoxy.org/ vulnerability 
fastcgi index index.php; 


location -* N.html$ { 
expires -1; 


location -* \.(css|js|gif|jpe?g|png)$ { 
expires 1M; 
add header Pragma public; 
add header Cache-Control "public, must-revalidate, proxy-revalidate"; 


gzip on; 

gzip http version 1.1; 

gzip vary on; 

gzip comp level 6; 

gzip proxied any; 

gzip types application/atom+xml 
application/javascript 
application/json 
application/vnd.ms-fontobject 
application/x-font-ttf 
application/x-web-app-manifest+json 
application/xhtml+xml 
application/xml 
font/opentype 
image/svg+xml 
image/x-icon 
text/css 
text/plain 
text/xml; 

gzip_buffers 16 8k; 

gzip disable "MSIE [1-6]\.(?!.*SV1)"; 


Lighttpd 


添加 下 述 配置 到 你 的 服务 器 配置 块 : 


url.rewrite-if-not-file = ( 
"/admin.*" => "/admin.php", 
"/api.*" => "/api.php", 
DAR a => "/index.php" 


故障 排除 


如 果 你 在 安装 Flarum 中 遇 到 问题 ， 记 得 检查 支持 论坛 的 Installation 标签 一 一 也许 有 人 和 你 
遇 到 了 相同 的 问题 ! 如 果 没 有 ， 发 起 讨论 ， 我 们 会 尽 可 能 帮 你 解决 。 


目前 还 没有 配置 SMTP 的 图 形 化 界面 (#258)， 但 您 可 以 手动 修改 数据 库 的 config 表 : 


mail_driver: smtp 
mail_host: ... 
mail_port: ... 
mail_username: ... 
mail password: ... 
mail encryption: ... 


导入 数据 


最 终 我 们 希望 可 以 将 其 他 论坛 的 数据 导入 到 Flarum 中 ， 这 样 你 就 可 以 放心 地 迁移 到 Flarum 
软件 。 然而， 在 这 个 阶段 还 为 时 过 早 ， 我 们 需要 先 发 布 稳定 版 ! 


译 者 : @justjavac Updated by ttn! 17/1/21 


添加 语言 


sw 


在 Flarum 中 添加 一 种 新 的 语言 十 分 容易 ， 只 需 按照 下 述 的 流程 下 载 并 安装 你 选择 的 语言 包 即 
可 o 

你 添加 一 个 语言 包 之 后 ， 你 可 以 把 它 设置 成 你 的 论坛 的 默认 语言 。 不 论 何 时 你 感觉 不 需要 其 
中 一 个 安装 过 的 语言 包 了 ， 你 都 可 以 禁用 它 。 


如 果 你 正在 使 用 任何 第 三 方 的 扩展 ， 一 定 要 在 开始 动手 之 前 读 这 部 分 。 


EZ 包 的 安装 


ys 


第 一 步 ， 访 问 Flarum 42 E M 35 69 Extensions > Language 标 签 ， 并 找到 你 想 要 安装 的 语言 
包 。 一 定 要 确保 下 载 的 ZIP 文 件 是 符合 你 正在 运行 的 Flarum 版 本 的 。 


ui 


1. 解压 ZIP 文 件 并 阅读 附 上 的 readme.txt 文 件 中 的 说 明 。 

2. 通过 SSH，FTP， 或 者 你 的 服务 提供 商 的 控制 面板 来 登录 到 你 的 服务 器 。 
3， 跳 转 到 你 的 Flarum 安 装 的 extensions/ 目 录 。 

4. 创建 一 个 新 的 子 目录 。 按 照 说 明 里 指出 的 那样 来 命名 

5， 上 传 解压 出 的 文件 夹 里 的 所 有 东西 到 你 刚刚 创建 的 子 目 录 。 

6.， 用 浏览 器 跳 转 到 管理 界面 的 Extensions 页 面 。 
7， 选 择 你 刚刚 安装 的 语言 包 并 启用 它 


这 就 是 你 要 做 的 所 有 的 事 ! 你 现在 应 该 已 经 能 够 使 用 网 站 的 头 部 的 语言 选择 器 ， 切 换 你 论坛 
示 语言 至 新 的 语言 。 


UB Sida 


在 你 安装 了 新 的 语言 包 并 确认 它 能 顺利 工作 后 ， 你 可 能 想 要 把 它 设置 为 用 户 的 默认 显示 语 
言 。 你 可 以 在 管理 员 面板 的 Basic 页 面 设置 这 一 选项 。 


禁用 语言 包 
如 果 你 最 终 决 定 停止 支持 一 个 特定 的 语言 ， 你 可 以 把 它 关 掉 。 只 需要 在 管理 界面 里 定位 
到 Extensions 页 面 里 的 语言 包 并 禁用 它 


当 你 的 站 点 只 支持 一 个 语言 而 且 你 不 希望 网 站 的 头 部 出 现 一 
是 很 有 用 的 。 当 只 局 用 了 一 个 语言 的 时 候 ， 语 pa $ 


第 三 方 扩展 


尽管 从 Flarum 社区 网 站 上 下 载 的 语言 包 会 一 般 包括 所 有 和 Flarum 捆绑 的 扩展 的 翻译 ， 他 们 
不 会 是 一 个 在 你 安装 的 第 三 方 扩 展 上 也 起 作用 的 规则 。 由 开发 者 来 决定 是 否 提供 并 维护 他 们 
的 扩展 的 翻译 。 


所 以 当 你 安装 一 个 第 三 方 扩展 之 前 ， 你 应 该 检查 一 下 来 确保 它 包含 有 适用 于 你 所 安装 的 所 有 
语言 包 的 翻译 。 如 果 你 发 现 一 个 扩展 不 支持 你 需要 的 一 个 语言 ， 请 直接 联系 开发 者 并 协商 添 
加 必要 的 翻译 。 


译 者 : @imcaffrey Updated by ttnl 17/1/21 


故障 诊断 和 报告 


如 果 Flarum 无 法 安装 或 者 是 没有 按照 预期 运行 ， 第 一 件 需 要 做 的 事情 就 是 再 次 检查 你 的 环境 
是 否 达到 了 系统 要 求 。 如 果 你 缺失 部 分 Flarum 的 依赖 项 (例如 PHP 的 fileinfo 扩展 ) > 
o, 些 问 题 。 接 下 来 ， 你 应 该 花 上 几 分 钟 在 支持 论坛 和 问题 追踪 器 内 检索 。 有 
能 有 人 已 经 汇报 了 这 个 问题 ， 或 者 解决 方案 IN 。 在 检索 过 
， 如 果 你 仍然 没有 发 现 关于 这 个 问题 的 信息 的 话 ， 就 是 需要 进行 故障 诊断 的 时 候 了 。 


第 一 步 : 开启 调试 模式 。 


在 你 处 理 前 ， 你 应 该 开启 Flarum 的 调试 模式 。 仅 需 使 用 文本 编辑 器 打开 config.php 文件 ， 
将 debug 的 值 修改 为 true 。 这 样 ， 当 Flarum 发 生 任何 错误 时 ， 将 会 显示 详细 的 错误 消 


如 果 你 访问 网 站 时 看 到 一 个 空白 页 面 ， 将 PHP 配置 文件 php.ini 的 display_errors 选项 设 
EA on 。 或 者 ， 你 也 可 以 将 以 下 代码 添加 到 flarum/bootstrap.php 文件 的 开头 : 


ini set('display errors', 'On'); 
当 错 误 修 正 后 ， 一 定 要 恢复 这 些 选项 | 


HE 


第 二 步 : 复 现 错误 。 
试 着 让 错误 再 发 生 一 次 。 


Re-translated by @ttnl 17/1/21. First editon translated by @justjavac. 


使 用 API 


每 个 Flarum 论坛 都 有 一 个 公开 的 JSON API， 可 以 对 论坛 数据 进行 读 和 写 。 它 符合 JSON- 
API 1.0 规范 。 


身份 验证 


API 使 用 基于 令 牌 的 身份 验证 机 制 。 某 些 终端 不 需要 身份 验证 。 您 可 以 通过 /api/token 取得 
一 个 令 牌 : 


POST /api/token HTTP/1.1 


"identification": "Toby", 
"password": "pass7word" 


HTTP/1.1 200 OK 


"token": "YACub2KLfe8mfmHPCUKtt6t2SMJOGPXnZbqhc3nX" , 
USC rales Wal 
然后 ， 您 可 以 在 后 续 的 请 求 头 中 ， 包 含 此 身份 验证 令 牌 : 


GET /api/forum HTTP/1.1 
Authentication: Token YACub2KLfe8mfmHPcUKtt6t2SMJOGPXnZbqhc3nX 


e GET /api/forum - 关于 论坛 的 信息 ， 包 括 groups 和 tags 
e PATCH /api/forum - 更 新 论坛 配置 


Discussion 716 


e GET /api/discussions - 获取 所 有 的 讨论 (默认 排序 规则 为 -time ) 
o filter[q] -根据 username/gambits 过 滤 


e POST /api/discussions -创建 一 个 新 的 讨论 


e GET /api/discussions/:id -通过 1D 获取 讨论 
e PATCH /api/discussions/:id - 更 新 一 个 讨论 


e DELETE /api/discussions/:id - MERA AH 


Posts 帖子 


e GET /api/posts - 获取 所 有 帖子 
o filter[discussion] -根据 discussion ID 3 7& 
o filter[user] -根据 user ID 过滤 
o filter[number] -根据 数字 (discussion 中 的 位 置 ) 
o filter[type] -根据 post type 过 滤 
e POST /api/posts - 创建 一 个 新 的 帖子 
e GET /api/posts/:id -根据 ID 获取 一 个 帖子 
e PATCH /api/posts/:id - EMM 
e DELETE /api/posts/:id -删除 一 个 帖子 


Users 用 户 


e GET /api/users - 获取 所 有 用 户 
o filter[q] -根据 username/gambits 过 滤 
e POST /api/users - 注册 新 用 户 
e GET /api/users/:idOrUsername -根据 ID fe username 获取 一 个 用 户 
e PATCH /api/users/:id - 更 新 一 个 用 户 
e DELETE /api/users/:id - 删除 一 个 用 户 
e POST /api/users/:id/avatar - 更 新 用 户 头像 
e DELETE /api/users/:id/avatar - 删除 用 户 头像 


Groups 组 
e GET /api/groups - 获取 所 有 组 
e POST /api/groups -创建 一 个 新 的 组 


e PATCH /api/groups/:id - 更 新 一 个 组 
e DELETE /api/groups/:id - 删除 一 个 组 


Notifications 通知 


e GET /api/notifications - 获取 所 有 通知 


e PATCH /api/notifications/:id - 将 一 个 通知 标记 为 已 读 


Ak 


Tags 15 & 


4 


* POST /api/tags - 创建 一 个 新 标签 
e PATCH /api/tags/:id -更 新 一 个 标签 


e DELETE /api/tags/:id - 删除 一 个 标签 


译 者 : @justjavac 


构建 扩展 
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搜索 


Flarum 被 设计 成 轻 量 级 和 高 扩展 的 。 事 实 上 ，Flarum 的 大 部 分 特性 都 是 扩展 。 这 种 方式 使 得 
Flarum 可 定制 性 很 强 。 用 户 可 以 禁用 他 不 需要 的 特性 ， 或 者 安装 他 们 想 要 的 扩展 。 


为 了 达到 这 种 扩展 性 ，Flarum 拥有 丰富 的 接口 和 扩展 点 。 文 档 该 部 分 旨 在 指导 你 Flarum 如 
何 运作 ， 如 何 使 用 接口 构建 自己 的 扩展 。 


扩展 接口 还 不 稳定 ， 接 下 来 几 个 月 内 ， 这 种 状况 会 随 着 我 们 的 不 断 完善 而 改变 。 另 外 ， 
本 文档 也 未 完成 。 我 们 需要 你 的 反馈 ! 


核心 VS 扩展 


我 们 怎么 界定 Flarum 的 核心 和 扩展 ?为 什么 一 些 特 性 包含 在 了 核心 内 而 另 一 些 却 没有 呢 ? 理 
解 这 个 差异 对 我 们 维持 Flarum 生态 系统 的 一 致 性 和 高 质量 很 重要 。 


Flarum 的 核心 并 不 意图 去 包含 完整 特性 ， 相 反 ， 它 是 作为 脚手架 ， 或 者 说 是 框架 ， 为 扩展 提 
供 一 个 可 依赖 的 构建 基础 。 它 只 包 念 对 一 个 论坛 来 说 必要 的 、 基 础 的 、 不 可 缺失 的 功能 ， 这 
些 功能 有 讨论 、 帖 子 、 用 户 、 和 群 组 和 通知 。 

绑 定 的 扩展 是 随 Flarum 一 起 打包 的 特性 ， 上 默认 情况 下 是 开启 的 。 这 些 扩 展 和 其 他 扩展 一 样 是 
可 以 禁用 和 和 缉 载 的 。 尽 管 他 们 并 不 由 在 处 理 所 有 使 用 实例 ， 但 这 些 扩展 还 是 很 通用 并 且 被 配 
置 得 足够 好 ， 使 得 他 们 能 够 满足 大 部 分 情况 。 

第 三 方 扩展 是 其 他 人 制作 的 、 不 被 Flarum 团队 官方 支持 的 特性 。 他 们 应 当 被 构建 和 用 于 特定 
的 情形 。 

如 果 你 想 解决 核心 或 者 已 有 的 附带 扩展 的 bug 或 者 缺陷， 我 们 将 很 感激 你 对 相应 的 项 目 作 出 
贡献 而 不 是 分 散 精 力 在 一 个 新 的 第 三 方 扩展 上 。 在 Flarum 论坛 上 新 建 一 个 讨论 来 听 听 Flarum 
开发 者 的 意见 也 是 个 好 想法 。 


Flarum 如 何 运 作 

在 你 构建 扩展 之 前 ， 你 一 定 得 先 理解 Flarum 如 何 运 作 。 本 节 旨 在 快速 浏览 组 成 Flarum 的 各 
部 分 。 

从 顶层 来 看 ，Flarum 有 3 层 架 构 : 


。 领域 (domain) 层 ， 代 表 所 有 Flarum 数据 结构 和 领域 逻辑 。 
© 接口 (API) 层 ， 以 一 种 标准 格式 (如 JSON API) 暴 露 这 些 数据 结构 。 
e 客户 (client) 层 ， 提 供 默认 网 络 用 户 来 使 用 接口 。 


为 了 构建 扩展 ， 你 需要 了 解 一 点 如 何 去 扩 展 这 些 层 中 的 每 一 个 。 例 如 锁定 (Sticky) 扩 展 : 


e 扩展 领域 层 > 为 讨论 增加 一 个 新 的 is_sticky 属性 。 
e 扩展 接口 层 ， 允 许 通 过 JSON API 改变 属性 的 值 。 
e 扩展 客户 层 ， 增 加 一 个 讨论 控制 条 目 ， 该 条 目 被 点 击 时 会 调用 JSON API > 


让 我 们 更 深入 得 了 解 下 每 个 层 ， 知 道 他 们 是 如 何 构建 的 。 


领域 

领域 层 代 表 着 管理 论坛 数据 和 为 论坛 数据 建 模 。 这 包括 用 数据 库存 储 数据 、 提 供 程序 命令 去 
修改 数据 和 控制 相关 逻辑 (例如 当 一 个 用 户 发 帖 时 ， 我 们 在 用 户 发 帖 数 上 加 1)。 

领域 层 使 用 面向 对 象 的 PHP 来 构建 ， 位 于 Flarum\core 这 个 命名 空间 里 g 领域 层 的 每 个 实体 
(讨论 、 帖 子 等 ) 都 有 自己 的 子 命名 空间 。 

领域 层 依赖 Laravel 的 数据 库 组 件 和 Eloquent ORM。 每 个 实体 代表 一 个 Eloquent 活动 记录 
模型 。 这 些 模型 对 认证 、 许 可 、 扩 展 有 内 建 的 机 制 。 


为 了 提供 一 种 修改 数据 的 方式 ，Flarum 利用 命令 总 线 模式 以 及 Laravel 的 总 线 组 件 。 每 个 实 
体 都 有 各 种 命令 与 其 相 关联 (例如 Flarum\Core\Discussions\Commands\StartDiscussion , 

Flarum\Core\Posts\Commands\PostReply ), 这 些 命令 都 可 以 被 调用 来 作用 在 Flarum 的 领域 层 
上 。 


接口 
接口 层 位 于 领域 层 之 上 ， 提 供 能 读 写 论坛 数据 的 公有 的 JSON API 。 它 符合 JSON-API 1.0 规 
范 


接口 层 使 用 面向 对 得 的 PHP 来 构建 ， 存 放 在 Flarum\Api F ° 每 个 接口 端 都 有 相对 应 的 操作 
(Action)( 本 质 上 是 一 个 控制 器 )， 这 些 操作 接收 请 求 对 象 然后 返回 响应 。 


大 部 分 操作 使 用 tobscure/json-api 库 来 输出 一 个 JSON-API 文档 。 来 自 Flarum 领域 层 的 数 
据 通过 序列 化 被 转换 成 可 使 用 的 格式 。 写 数据 操作 使 用 命令 总 线 将 命令 发 送 到 领域 层 。 
EP 

客户 层 位 于 接口 层 之 上 ， 提 供 人 们 能 使 用 Flarum 的 用 户 界 面 。 客 户 层 有 两 部 分 : 一 个 基础 的 
只 读 内 容 的 HTML 版 本 ， 和 一 个 交互 的 单 页 JavaScript 应 用 。 两 者 都 使 用 JSON API. 


客户 层 HTML 利用 面向 对 象 的 PHP， 厅 放 在 Flarum\Forum 下 。 和 接口 层 相 似 ， 每 个 论坛 的 
路 由 (route) 有 一 个 对 应 的 操作 (本 质 是 控制 器 )， 这 个 操作 能 接收 PSR-7 请 求 并 返回 响应 . 


典型 的 客户 端 响应 包含 一 个 表现 页 面 内 容 的 基础 HTML 样式 ， 和 JavaScript 应 用 的 启动 代 
码 。 它 使 用 Laravel 的 视图 组 件 和 Blade 模板 系统 来 构建 。 


JavaScript 应 用 基于 Mithril FX > Mithril 是 一 个 和 React 4441614 $ 18 AER > JavaScript 
应 用 利用 Gulp 和 Babel 从 ES6 代码 库 转 换 而 来 。 


客户 层 还 包含 一 个 LESS CSS 编译 器 来 为 客户 端 应 用 编译 样式 表 。 


扩展 如 何 运 作 


现在 你 已 经 理解 了 Flarum 如 何 运 作 ， 让 我 们 来 看 看 关于 如 何 扩展 Flarum 。 


事件 


在 Flarum 后 端的 PHP 代码 (例如 领域 层 、 接 口 层 、 部 分 客户 层 ) 中 ， 有 许多 事件 ， 而 扩展 
可 以 监听 这 些 事 件 ， 或 者 对 事件 作出 响应 。 例 如 ， 开 始 一 个 讨论 后 ， DiscussionWasStarted 
事件 被 触发 。 扩 展 可 以 监听 这 个 事件 ， 这 样 当 一 个 讨论 开始 后 就 能 发 送 菜 种 通知 。 


在 Flarum\Events 命名 空间 下 的 所 有 事件 都 能 被 监听 . 


监听 事件 很 简单 ， 只 需要 在 事件 调度 程序 中 调用 listen 方法 ， 并 传 给 它 一 个 事件 的 类 名 
和 控制 事件 的 闭 包 。 你 能 在 打包 章节 学 习 到 更 多 关于 如 何 注册 事件 监听 者 。 


猴子 补丁 
扩展 Flarum 的 前 端 JavaScript 应 用 采用 了 一 种 叫 猴 子 补 丁 的 概念 .猴子 补丁 可 以 在 运行 时 替 
代 一 些 原 有 的 函数 、 方 法 和 属性 。 


Flarum 的 前 端 用 户 Tu 组 件 组 成 ， 这 些 组 件 都 是 一 个 类 。 扩 展 可 以 用 猴子 补丁 的 方式 
修改 这 些 类 的 方法 ， 适 当 改 变 返回 值 。 例 如 ， 一 个 扩展 可 以 猴子 补丁 Discussioncontrols 类 
的 moderationcontrols 方法 来 添加 一 个 新 的 锁定 谈论 的 按钮 . 


你 将 会 在 扩展 客户 端 章节 学 到 更 多 关于 如 何在 Flarum 的 JavaScript 应 用 中 运用 猴子 补丁 。 


译 者 : @theFool32 


在 开始 写 扩 展 之 前 ， 你 需要 在 系统 上 配置 如 下 几 个 工具 : 


e 下 载 并 全 局 安装 Composer ， 为 扩展 生成 自动 加 载 。 
e 配置 Node.js 并 全 局 安装 Gulp ， 编 译 扩展 的 客户 端 JavaScript 。 


除 此 之 外 ， 你 也 可 以 安装 Flarum 的 Vagrant 开发 者 镜像 ， 它 帮 你 自动 装 好 了 所 有 工具 。 


生成 框架 


Flarum 有 便利 n ne > 这 样 你 就 可 以 马上 开始 写 代 码 了 。 打 开 终 端 并 
在 论坛 根 目 录 运 行 下 面 的 命 


php flarum/flarum generate:extension 


ia 些 细节 。 扩 展 名 是 扩展 独一无二 的 名 称 ， 只 能 包含 数字 、 字 母 和 连 字符 
空间 用 来 分 离 你 的 代码 ; 你 可 以 把 提供 者 名 Map (例如 
TobscureVAttachments ) 作 为 命名 空间 . 


2 
N 


旦 你 十 完 所 有 细节 ， 工 具 会 在 你 论坛 根 目 录 的 extensions A | 目录 。 完 成 
这 些 可 外 a. 下 面 让 我 们 看 下 生成 了 些 什么 


e bootstrap.php 如 果 你 的 扩展 被 启用 ，Flarum 会 在 每 当 有 请 求 时 加 载 这 个 文件 。 这 个 文 
件 是 扩展 启动 的 地 方 ! 你 不 应 该 修改 它 。 

e flarum.json 包含 你 扩展 的 元 信息 (标题 、 描 述 、 作 者 、 依 赖 项 )。 更 多 信息 请 往 下 看 。 

e jsl 存放 扩展 的 JavaScript 文件 。 你 将 在 扩展 客户 端 了 解 到 更 多 。 

e less! 存放 扩展 的 CSS 文件 。 你 将 在 主题 了 解 到 更 多 。 

locale! 存放 扩展 的 翻译 文件 。 你 将 在 国际 化 了 解 到 更 多 。 

migrations/ 当 扩 展 被 安装 /升级 /卸载 时 会 运行 数据 迁移 。 你 将 在 域 扩 展 了 解 到 更 多 。 

e srcl 存放 扩展 的 后 端 源 代码 ， 将 被 使 用 PSR-4 标准 的 Composer 自动 加 载 。 


flarum.json 


文档 待 写 。 


事件 订阅 者 


就 像 你 从 介绍 里 了 解 到 的 一 样 ， 扩 展 工作 的 唯一 方式 就 是 监听 和 响应 事件 。 让 我 们 看 下 这 是 
如 何 实现 的 。 


我 们 将 从 头 开始 。 如 果 你 看 过 bootstrap.php ， 你 会 发 现 它 返回 一 个 扩展 类 的 名 字 。 如 果 扩 
展 启用 了 ， 在 每 个 请 求 的 开始 ，Flarum 会 包含 这 个 文件 并 且 把 这 个 类 注册 为 一 个 服务 提供 
者 。 这 个 类 是 你 处 理事 务 的 关键 。 


我 们 再 继续 看 ，Flarum 在 src 目录 下 生成 了 这 个 类 。 如 果 你 仔细 看 ， 你 会 发 现 这 个 独立 的 
方法 : 


public function listen(Dispatcher $events) 


{ 


$events->subscribe('Your\Namespace\Listeners\AddClientAssets'); 


} 


当 事 件 系统 建立 起 来 后 ，Flarum 就 会 调用 每 个 扩展 服务 提供 者 的 listen 方法 。 它 传递 一 个 
Laravel 的 消息 分 发 实体 ， 因 此 你 能 如 你 所 愿 得 监听 事件 。 


但 我 们 在 这 做 了 些 不 同 的 事 。 我 们 调用 subscribe 方法 去 注册 一 个 事件 订阅 者 而 不 是 直接 添 
加 事件 监听 器 . 订阅 者 是 分 组 相关 事件 监听 器 的 一 种 ， 它 能 帮助 你 组 织 代 码 。 你 可 以 按 你 喜欢 
的 方式 组 织 你 的 事件 监听 器 ， 但 Flarum 的 附带 扩展 采用 订阅 者 的 任务 + 订阅 者 名 (例如 


AddClientAssets 或 AddApiAttributes ) 的 约定 。 


好 了 ， 让 我 们 再 看 下 生成 的 Addclientassets 监听 器 。 


use Flarum\Events\RegisterLocales; 
use Flarum\Events\BuildClientView; 
use Illuminate\Contracts\Events\Dispatcher; 


class AddClientAssets 


{ 
public function subscribe(Dispatcher $events) 
{ 
$events->listen(RegisterLocales::class, [$this, 'addLocale']); 
$events->listen(BuildClientView::class, [$this, 'addAssets']); 
^ 


我 们 注册 事件 监听 器 的 地 方 。 我 们 导入 event 类 ， 然 后 在 订阅 者 的 subscribe 方法 里 调 


这 是 
用 分 发 器 的 listen) ， 传递 的 参数 是 我 们 希望 订阅 的 事件 名 称 和 处 理事 件 的 方法 。 


这 些 特 定 的 事件 监听 器 用 来 处 理 默 认 的 本 地 化 语言 包 、 Javesenpt fe CSS 文件， 这些 都 是 在 
创建 扩展 的 时 候 由 系统 自动 生成 。 你 可 以 在 扩展 客户 端 章节 了 解 到 关于 他 们 得 更 多 信息 


译 者 : @theFool32 


打包 
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扩展 域 


如 介绍 所 述 ， 域 (Domain) 层 负责 管理 和 抽象 化 论坛 数据 。 这 包括 在 数据 库 中 贮存 数据 ， 提 供 
编程 命令 以 修改 数据 ， 并 处 理 相 关 逻 辑 (比如 ， 当 用 户 发 了 帖子 ， 我 们 就 在 用 户 的 帖子 数 统 
计 上 加 一 ) o 


在 本 节 我 们 将 深入 探讨 如 何 扩 展 Flarum 的 域 。 


迁移 


如 果 您 的 扩展 引入 了 一 种 新 的 实体 (如 ， 或 者 将 新 属性 添加 到 了 一 个 现 有 的 实体 (例如 
discussions 的 is_sticky 属性 j^ 那么 你 需要 更 新 Flarum 的 数据 库 架 构 ， 来 存储 新 的 数 
据 。 


可 通过 迁移 (migrations) 来 实现 这 一 工作 ; Flarum 中 的 迁移 基于 Laravel 49 ZIL » HBX 
件 必 须 放 在 扩展 的 migrations 文件 夹 下 ， 命名 时 应 包括 时 间 惟 和 对 其 所 作 修 改 的 描述 ， 如 
下 所 示 : 


2015 02 24 000000 create tags table.php 





此 文件 应 该 包括 一 个 扩展 自 FlarumWMigrationsWMigration 的 类 ， 并 附 有 相同 的 描述 。 每 个 迁 
移 类 包括 两 个 方法 : up 和 down ° up 方法 在 你 的 扩展 启用 时 调用 (如 果 该 迁移 以 前 没有 
进行 过 ) ， 因 此 你 可 以 在 数据 库 中 添加 新 的 表 、 列 、 索 引 等 等 ， 亦 可 执行 其 他 安装 操 

ft ^ down 操作 在 扩展 扼 载 时 被 调用 ， 应 能 够 回 滚 up 操作 所 执行 的 行为 。 


迁移 可 调用 $schema 变量 ， 此 为 Laravel 的 架构 生成 器 的 一 个 实例 ， 用 来 对 数据 库 架 构 进 行 
调整 : 


use Illuminate\Database\Schema\Blueprint; 
use Flarum\Migrations\Migration; 


class CreateTagsTable extends Migration 


{ 
public function up() 
{ 
$this->schema->create('tags', function (Blueprint $table) € 
Stable->increments('id'); 
$table->string('name', 100); 
$table->string('slug', 100); 
Stable->text('description')->nullable(); 
}); 
} 
public function down() 
{ 
$this->schema->drop('tags'); 
} 
} 


如 果 需 要 在 不 重新 启用 某 个 扩展 的 情况 下 运行 迁移 ， 只 需 简单 地 执行 升级 命令 即 可 : 


php flarum upgrade 


扩展 模型 


为 了 使 用 您 设置 的 新 数据 库 结构 ， 你 需要 创建 新 的 模型 (Model) 或 对 现 有 的 模型 加 以 扩展 。 在 
Flarum 中 ， 每 个 模型 都 扩展 自 Flarum\core\mModel > 2478 A Laravel 的 Eloquent\Model 类 的 
扩展 。 在 此 详细 了 解 Eloquent 模型 。 


属性 
在 Eloquent 模型 中 ， 你 无 需 为 定义 属性 而 烦恼 。 你 可 以 像 调 用 实例 的 属性 一 样 调用 它 ， 比 如 
$discussion->is_sticky ° 这 一 切 使 得 事情 变 得 很 简单 。 


然而 有 一 个 例外 : 如 果 你 添加 了 一 个 日 期 属性 ， 你 需要 告诉 模型 此 属性 应 被 视 为 日 期 。 可 通 
过 侦 听 ModelDates 事件 来 实现 : 


use Flarum\Core\Discussions\Discussion; 
use Flarum\Events\ModelDates; 


$events->listen(ModelDates::class, function (ModelDates $event) 4 
if ($event->model instanceof Discussion) { 
$event-»dates[] = 'stickied at'; // stickied at 被 作为 日 期 属性 


每 次 保存 模型 时 ， 其 数据 将 根据 使 用 Laravel 验证 组 件 以 一 套 规 则 加 以 验证 。 扩 展 可 以 修改 这 
些 规则 ， 所 以 您 可 以 在 模型 属性 上 执行 额外 的 验证 。 


use Flarum\Core\Users\User; 
use Flarum\Events\ModelValidator; 


Sevents->listen(ModelValidator::class, function (ModelValidator $event) 4 
if ($event->model instanceof User) { 
// Make usernames require at least 5 characters 
// username 至 少 5 个 字符 
$event ->validator->mergeRules('username', 'min:5'); 


如 果 您 需要 对 已 有 的 模型 定义 一 个 新 的 关系 ， 可 以 使 用 WwodelRelationship 事件 。 每 个 未 知 
的 方法 或 属性 连接 模型 时 ， 都 将 调用 此 事件 。 如 果 你 关系 的 名 称 与 方法 的 名 称 匹 配 ， 你 应 该 
使 之 返回 一 个 Eloquent Relation 对 象 ， 该 对 象 应 使 用 模型 hasone ，belongsTo ， 
belongsToMany ,或 者 其 他 关系 方法 。 


use Flarum\Core\Discussions\Discussion; 
use Flarum\Events\ModelRelationship; 


Sevents->listen(ModelRelationship::class, function (ModelRelationship Sevent) 4 


if ($event->model instanceof Discussion && $event->relationship === 'category') { 
return $event->model->belongsTo('category'); 


3); 


数据 持久 化 


如 介绍 中 所 述 ，Flarum 使 用 命令 总 线 模式 〈 译 者 注 : 请 参见 本 文档 。) 提供 对 数据 进行 修改 
的 方法 。 为 了 能 够 使 一 个 核心 实体 中 的 所 有 新 属性 /关系 保存 到 数据 库 ， 你 需要 注意 会 发 生 什 
Zo 
让 我 们 用 一 个 例子 来 说 明 这 个 过 程 。 当 我 们 对 /discussions/123 入 口 点 进行 PATCH 请 求 
时 ， 将 会 进行 下 列 过 程 : 
1. 请 求 传递 到 合适 的 API 行为 类 ( Flarum\api\actions\Discussions\updateAction ) ° 
2. 该 操作 创建 Flarum\Core\Discussions\Commands\EditDiscussion 命令 的 新 实例 z 并 把 请 求 
输入 进行 封装 。 
3. 该 行为 把 命令 发 送 至 命令 总 线 ， 将 其 传递 给 适当 的 命令 处 理 程序 : 
Flarum\Core\Discussions\Commands\EditDiscussionHandler 
4. EditDiscussionHandler 根据 输入 的 命令 ， 对 讨论 模型 进行 修改 ， 并 保存 此 讨论 。 
在 第 四 步 时 piscussionwillBesaved 事件 会 被 发 送 。 这 是 在 保存 前 ， 扩 展 用 来 检查 输入 、 并 对 
模型 进行 的 附加 修改 的 时 机 。 


use FlarumNEventsNDiscussionWillBeSaved; 
$events->listen(DiscussionWillBeSaved::class, function (DiscussionWillBeSaved $event) 
{ 

if (isset($event->data['attributes']['isSticky'])) { 


$event-»discussion-»is sticky = $event->data['attributes']['isSticky']; 


3); 


权限 


Flarum 包括 一 个 功能 强大 的 权限 系统 。 它 使 得 扩展 能 自行 定义 操作 逻辑 ， 人 允许 或 不 允许 某 些 
用 户 或 组 对 某 些 实体 执行 特定 行为 。 


当 你 需要 确定 是 否 用 户 可 以 在 模型 上 执行 操作 时 ， 可 调用 该 模型 的 can() 方法 (在 
Flarum\Core\Support\Locked 中 定义 ) 当 用 户 被 允许 就 返回 ture ^ A ZW] false ° 


$allowed = $discussion-»can($user, 'sticky'); 


扩展 可 以 使 用 Modelallow 事件 挂 接 于 此 ， 返 回 ture X false 来 授予 或 拒绝 用 户 相关 权 
限 。 


use Flarum\Core\Discussions\Discussion; 
use Flarum\Events\ModelAllow; 


$events->listen(ModelAllow::class, function (ModelAllow Sevent) { 


if ($event->model instanceof Discussion && $event->action === 'sticky') ( 
// Allow the user to sticky the discussion if they authored it 
// 允许 作者 置顶 自己 的 讨论 
if ($event->actor->id === $event->model->user_id) { 

Return enue, 

d 

} 

3); 


优先 级 


值得 注意 的 是 ， 当 注册 一 个 事件 监听 器 时 ， 你 可 以 传递 一 个 整数 作为 第 三 参数 ， 从 而 给 事件 
监听 器 对 应 的 优先 级 。 这 对 于 ModelAllow 事件 相当 有 用 ， 能 使 在 返回 第 一 个 非 空 值 时 ， 停 
止 执 行 后 续 的 事件 监听 器 。 

组 的 权限 


Flarum 具有 关于 组 和 对 应 授予 的 基本 权限 的 映射 〈 可 在 后 台 权 限 页 加 以 修改 ) 。 此 信息 存储 
在 数据 库 的 权限 表 中 ， 并 可 以 在 用 户 模型 上 使 用 hasPermission() 方法 访问 : 


$granted = $user->hasPermission( 'discussion.sticky'); 
对 管理 员 组 的 用 户 而 言 ， 此 方法 总 是 返回 true (也 就 是 说 ， 管 理 员 有 权 进 行 一 切 事务 ) > 
其 他 情况 ， 它 将 返回 true 或 false ， 具 体 取 决 于 用 户 所 在 的 组 和 对 应 权限 映射 。 


这 个 系统 与 模块 锁 系 统 相 和 连接 ， 从 而 使 得 在 被 授权 的 某 组 中 的 用 户 能 做 规定 的 行为 。 默 认 情 
况 下 ， 在 discussion 模块 上 检查 用 户 是 否 能 做 对 应 行为 时 ， 会 检查 其 所 在 组 的 discussion. 
{action} 许可 。 对 于 posts ^ users fe groups 上 亦 如 此 。 


若 要 了 解 如 何在 后 台中 添加 权限 设置 ， 请 参阅 管理 章节。 


TRA 
模块 锁 仅 在 检查 已 取得 数据 库 的 模型 时 有 用 。 为 了 筛选 哪 种 模式 应 该 最 先 从 数据 库 中 取出 ( 比 
如 确定 哪些 讨论 /帖子 是 对 用 户 可 见 的 )，Flarum 使 用 一 种 机 制 称 为 可 见 范围 。 


可 见 范围 只 是 一 套 能 在 查询 数据 库 模型 时 可 应 用 的 条 件 语句 。 可 以 使 用 wherevisibleTo() 方 
法 应 用 此 范围 (该 方法 在 Flarum\Core\Support\VisibleScope PÆL) : 


// Olny get discussions which are visible to $user 
// 仅 获 取 对 $user 用 户 可 见 的 帖子 


$discussions = Discussion: :whereVisibleTo($user)->get(); 


扩展 可 以 使 用 scopeModelvisibility 事件 挂 接 于 此 ， 应 用 限定 条 件 于 查询 生成 器 : 


am 。 


use Flarum\Core\Discussions\Discussion; 
use Flarum\Events\ScopeModelVisibility; 


$events->listen(ScopeModelVisibility::class, function (ScopeModelVisibility $event) { 
if ($event->model instanceof Discussion) { 


// Only let the user see discussions which they started 
// 用 户 只 能 看 到 自己 发 起 的 讨论 


$event ->query->where('start_user_id', $event->actor->id); 


3) 


帖子 可 见 范围 
我 们 使 用 一 个 简单 的 模式 来 第 选用 户 可 见 帖子 : 


$posts = $discussion-»postsVisibleTo($user)-»get(); 


同样 地 ， 扩 展 可 使 用 scopePostvisibility 事件 来 挂 接 到 此 方法 ， 并 对 查询 生成 器 应 用 限定 
条 件 。 此 事件 包含 了 对 帖子 讨论 的 查询 。 
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API 


正如 介绍 所 述 ，Flarum 有 一 个 公开 的 JSON API 允许 你 读 写 论坛 数据 。 它 符合 JSON-API 
1.0 规范 。 


在 本 节 中 我 们 将 深入 探讨 如 何 扩展 Flarum 的 API ° 


JSON-API 和 序列 化 程序 (Serializers) 


Flarum 使 用 tobscure/json-api 库 来 输出 符合 JSON-API 规范 的 格式 化 数据 。 这 涉及 序列 化 程 
序 的 使 用 ? 该 程序 是 Flarum\Api\Serializers 命名 空间 下 的 一 个 类 ， 能 将 Flarum 的 数据 转 
换 成 一 个 可 被 公开 接受 的 格式 。 


属性 
可 使 用 ApiAttributes 事件 对 序列 化 程序 进行 增 改 : 


use Flarum\Api\Serializers\DiscussionSerializer; 
use Flarum\Events\ApiAttributes; 


$events->listen(ApiAttributes::class, function (ApiAttributes $event) { 
if ($event->serializer instanceof DiscussionSerializer) { 
$event->attributes['isSticky'] = (bool) $event->model->is_sticky; 
Sevent->attributes['canSticky'] = $event->model->can($event->actor, 'sticky'); 


3); 


可 使 用 ApiRelationship 事件 来 添加 新 的 关系 模型 。Flarum 的 底层 Serializer 类 提供 了 两 个 
方便 的 方法 ( hasone 和 hasMany ) ? 可 构建 一 个 Tobscure\JsonApi\Relationship Ro AR 
处 理 模 型 之 间 的 关系 。 


use Flarum\Api\Serializers\DiscussionSerializer; 
use Flarum\Events\ApiRelationship; 


$events->listen(ApiRelationship::class, function (ApiRelationship Sevent) 4 
if ($event->serializer instanceof DiscussionSerializer && $event->relationship === 
'tags') { 
return $event-»serializer--hasMany('FlarumNTagsNApiNTagSerializer'); 





y Zh 


为 使 这 些 关系 能 被 对 应 文档 所 链接 或 包 














行为 


Flarum 的 API 端点 (endpoint) 在 Flarum\Api\apiServiceProvider 中 定义 。 通 过 路 由 
(route) ， 每 个 端点 都 与 一 个 对 应 的 行为 《Action ) 类 相连 接 ， 该 类 实际 上 是 一 个 控制 器 。 
这 个 行为 类 可 以 接受 一 个 FlarumwpiNRequest 对 象 ， 并 以 PSR-7 格式 响应 。 


在 Flarum\Api\Action 命名 空间 下 有 大 量 的 抽象 行为 类 ， eres 些 类 来 方便 地 实现 数据 
库 操作 (译注 : 原文 作 CRUD actions, 请 参见 维基 百科 ) 。 其 中 包 

SerializeResourceAction 和 SerializeCollectionAction 类 ， oe 将 为 你 进行 设置 和 在 
序列 化 程序 中 传递 数据 的 所 有 工作 。 初 学 者 仅 需 实现 data 方法 并 以 Eloquent 模型 (译注 : 
此 为 Laravel 功能 ， 请 参见 官方 文档 ) 或 集合 (Collection) 形 式 返 回 即 可 。 


更 改行 为 属性 


data 方法 接受 一 个 请 求 对 象 和 几 个 额外 的 参数 : sort ， include > link > limit 和 
offset 。 这 些 参数 使 用 行为 类 中 的 配置 来 进行 处 理 ， 扩 展 程序 可 以 使 用 Buildapiaction 事 
件 修 改 这 些 配 置 ， 以 允许 添加 新 的 关系 、 新 的 可 排序 字段 ， 诸 如 此 类 。 


use Flarum\Api\Actions\Discussions; 
use Flarum\Events\BuildApiAction; 


$events->listen(BuildApiAction::class, function (BuildApiAction $event) { 
if ($event->action instanceof Discussions\IndexAction | | 
$event->action instanceof Discussions\ShowAction | | 
$event->action instanceof Discussions\CreateAction | | 
$event->action instanceof Discussions\UpdateAction) ( 
// Include the tags relationship on discussion resources by default 
$event ->addInclude('tags'); 


3) 


添加 API 端点 


如 果 您 需要 添加 一 个 新 的 API 端点 ， 可 从 任何 Action 基 类 加 以 扩展 ， 然 后 使 用 
RegisterApiRoutes 事件 注册 新 路 由 即 可 : 


use Flarum\Events\RegisterApiRoutes; 


$events->listen(RegisterApiRoutes::class, function (RegisterApiRoutes $event) { 
$event ->get ( 
'/tags', // The endpoint URI 
'api.tags.index', // A unique name for the endpoint 
'FlarumNTagsNApiNIndexAction' // The Action class to handle the request 
); 
15 


4 : @ttnl 


在 简介 一 节 中 我 们 提 到 ， 客 户 端 层 暴露 了 一 个 供 人 类 使 用 的 用 户 界面 。 客 户 端 由 两 部 分 组 
成 : 一 个 只 读 的 简单 HTML 页 面 和 一 个 可 交互 的 单 页 JavaScript 应 用 。 两 者 都 从 JSON API 
读 取 数 据 。 


路 由 


论坛 所 有 的 默认 路 由 都 在 Flarum\Forum\ForumServiceProvider 中 注册 。 每 个 路 由 有 一 个 对 应 
的 Action (动作 ) 类 ， 这 个 类 本 质 上 就 是 控制 器 。 每 个 动作 接受 一 个 PSR-7 请 求 ， 并 返回 


一 个 响应 o 


9 


Flarum\Forum\Actions\ClientAction 是 动作 类 的 基 类 ， 它 会 构建 一 个 clientview 实例 ， 并 
将 这 个 实例 回应 给 客户 端 。 clientview 是 一 个 高 度 可 定制 的 、 包 括 前 端 JavaScript 应 用 所 
需要 的 所 有 资源 文件 的 主 模板 。 例 如 你 可 以 : 


Edd 


e 用 setritle() 设置 文档 标题 。 

e 用 setContent() 设置 页 面 的 SEO 内 容 (在 <noscript> 标签 中 显示 的 内 容 ) s 
e 用 setDocument() 设置 页 面 中 需要 预 加 载 的 API 响应 。 

e 用 addHeadstring() 或 addFootstring() 在 页 面 的 头 部 或 尾部 添加 HTML 内 容 。 


新 的 论坛 路 由 可 以 通过 RegisterForumRoutes 事件 来 注册 。 例 如 : 


use Flarum\Events\RegisterForumRoutes; 


$events->listen(RegisterForumRoutes::class, function (RegisterForumRoutes $event) { 
$event ->get ( 
'/tags', // 路 由 URI 
'forum.tags', // 路 由 的 唯一 名 字 
'FlarumNTagsNForumNTagsAction' // 响应 请 求 的 动作 类 (可 选 ) 
); 
1; 


定义 响应 请 求 的 动作 类 (第 三 个 参数 ) 是 可 选 的 。 如 果 没 有 指定 ，Flarum 会 用 默认 的 空白 


ClientAction 来 响应 a 


JavaScript 应 用 


Flarum 最 好 的 一 部 分 就 是 运行 交互 式 JavaScript 前 端 应 用 。Flarum 的 前 端 采 用 一 个 
和 React 很 像 的 轻 量 级 的 泻 业 框架 Mithril 构建 。 下 面 的 内 容 假 设 你 对 Mithrill HA » HA 
了 解 一 些 React 的 思想 。 


编译 资源 文件 


Flarum 的 前 端 JavaScript 应 用 采用 ES6 编写 ， 并 通过 Gulp 与 Babel 转译 成 ES5。 前 端 大 
量 使 用 ESO 模块 ， 并 转译 成 System.js 格式 。 扩 展 的 JavaScript 也 应 当 如 此 编写 。 


Flarum 为 你 生成 的 扩展 框架 包含 了 所 有 制作 扩展 所 需 的 必要 工具 。 切换 到 js/forum 目录 ， 
执行 下 面 的 命令 就 可 以 编译 你 扩展 的 JavaScript 文件 。 


gulp watch 


编译 后 的 JavaScript 文件 会 输出 到 TGA SAS js 。 这 个 文件 必须 注册 到 客户 

端的 资源 管理 器 中 ， 否 则 不 会 加 载 。 另外 ， 还 需要 注册 一 个 加 载 器 ， 这 样 在 前 端 JS 应 用 启 

动 的 AAA 的 扩展 代码 。 你 可 以 在 Buildclientview 事件 中 这 人 么 做 (自动 生成 的 框 
架 中 已 经 包含 了 这 部 分 代码 ) 


use FlarumNEventsNBuildClientView; 


$events->listen(BuildClientView::class, function (BuildClientView $event) { 
$event ->forumAssets([ 
DIR_.'/../../js/forum/dist/extension.js' 


1D); 


$event ->forumBootstrapper('extension-name/main'); 


y; 


运行 时 扩展 (Monkey Patching) 


在 加 载 器 中 注册 了 你 的 main 模块 后 ， 前 端 应 用 会 在 开始 执行 真正 的 逻辑 前 运行 你 在 
js/forum/src/main.js 中 写 的 代码 。 这 样 ， 你 的 扩展 就 有 机 会 修改 你 想 要 改 的 东西 了 。 


在 简介 一 节 中 我 们 曾 一 笔 带 过 的 提 到 我 们 可 以 通过 monkey-patching 替换 函数 。Flarum 提供 
了 两 个 帮助 你 操作 的 函数 。 这 两 个 函数 是 extend 和 override ， 可 以 通过 flarum/extend 
导入 。 调 用 这 两 个 函数 时 ， 只 需 传 入 你 想 要 修改 的 对 象 (通常 来 说 是 某 个 类 的 原型 ) 、 你 想 
要 修改 的 属性 和 一 个 回调 函数 即 可 。 


extend 函数 中 ， 回 调 函 数 是 在 原来 的 方法 运行 完 之 后 被 调用 的 。 它 会 把 原来 的 执行 结果 传 
入 你 的 回调 函数 ， 这 样 你 可 以 修改 返回 值 。 

override HAF > TARAA 茜 换 原来 的 方法 。 它 会 将 原来 的 方法 传 入 ， 如 果 你 需要 ， 可 

以 在 回调 中 随时 调用 它 。 


下 面 的 这 两 个 例子 演示 了 这 两 个 函数 的 使 用 方式 : 
import fextend, override} from 'flarum/extend'; 


class Foo { 
aMethod() { 
return { 
color: 'red' 


}; 
} 


bMethod() { 
return 'Gday'; 
} 
} 


const foo = new Foo(); 
foo.aMethod(); // {color: 'red'} 
foo.bMethod(); // 'Gday' 


extend(Foo.prototype, 'aMethod', value => { 
value.color = 'yellow'; 


3); 


override(Foo.prototype, 'bMethod', original -» ( 
return original() + ' mate'; 


3); 


foo.aMethod(); // {color: 'yellow'} 
foo.bMethod(); // 'Gday mate' 


和 类 型 、 返 回 值 的 类 型 ) 一 致 。 


组 件 是 一 些 构建 Fluarm 的 UI 的 可 重用 片段 。 你 可 以 在 这 里 找到 所 有 的 组 件 。 


组 件 是 在 Mithril 的 组 件 系 统 上 用 React 的 方式 实现 的 。 一 个 组 件 必须 继承 
flarum/Component 并 实现 view) 方法 (默认 的 扩展 工具 会 将 ISX 转 义 成 Mithril 的 mO $ 
数 ) 。 


class WelcomeMessage extends Component { 


view() { 
return. ( 
<div className="WelcomeMessage"> 
<hi>Hello, {this.props.name}!</hi> 
</div> 
); 
} 
} 


一 个 组 件 可 以 通过 config() 方法 和 它 的 根 DOM 元 素 互动 。 这 个 方法 和 Mithril 67 config 


API 几乎 是 一 样 的 实现 ， 只 有 一 点 不 同 : 它 没 有 传 入 第 
SO 来 操作 这 个 元 素 ， 就 像 用 一 个 jQuery 对 象 一 样 。 


config(isInitialized, context) { 


if (isInitiailized) return; 


this.$().on('click', () => alert('clicked')); 


345% (ItemList ) 


类 是 一 个 通过 名 字 来 收集 和 整理 对 象 的 数组 。 例 如 


ItemList 


import ItemList from 'flarum/utils/ItemList'; 


const items = new ItemList(); 


items.add('foo', 'Foo'); 
items.add('bar', 'Bar'); 
items.add('qux', 'Qux', 10); // 更 高 优先 级 的 对 象 会 排 在 前 面 


delete items.foo; // 删除 一 个 对 象 


items.bar.content = 'Baz'; // 改变 一 个 对 象 的 内 容 


items.toArray(); // ['Qux', 'Baz'] 


许多 组 件 和 其 它 的 实用 工具 会 返回 一 个 ItemList 的 实例 (通常 
结尾 ) o 例如， CommentPost 组 件 的 headerItems() 方法 就 返 


其 中 包含 每 条 帖子 的 头 部 。 你 可 以 用 运行 时 扩展 来 修改 它们 : 


一 个 参数 ( element ) 


。 你 可 以 用 


来 说 它们 的 方法 名 字 以 ltems 
回 一 个 ItemList 的 实例 ， 


import CommentPost from 'flarum/components/CommentPost ' ; 


extend(CommentPost.prototype, 'headerItems', function(items) { 
items.add('location', ' 这 个 用 户 住 在 ' + this.props.post.user().location()); 


3); 


应 用 全 局 变量 


app 全 局 变量 是 flarum/ForumApp 的 实例 ， 你 可 以 通过 这 个 变量 来 访问 整个 应 用 级 别 的 组 件 


存储 (Store) 
tk (Store) 是 一 个 和 Flarum 后 端 API 交互 的 对 象 ， 可 以 通过 app.store 来 访问 。 


存储 会 将 在 API 响应 中 的 资源 和 Models 关联 起 来 。Models 会 让 访问 对 象 和 关系 变 得 容易 起 
来 。 例 如 ， 主 题 的 model 的 一 部 分 代码 是 这 样 的 : 


class Discussion extends mixin(Model, { 
title: Model.attribute('title'), 
startTime: Model.attribute('startTime', Model.transformDate), 
startUser: Model.hasOne('startUser'), 
posts: Model.hasMany('posts'), 


要 通过 API 获得 一 个 主题 的 model * M store 的 find 方法 就 行 了 。 find 方法 会 返回 一 个 
promise。 例 如 : 


app.store.find('discussions', 1).then(discussion => { 
discussion.id(); // "1" 
discussion.title(); // "Discussion title" 
discussion.startUser(); // flarum/models/User 1% 


3); 


你 也 可 以 用 find 方法 进行 更 加 复杂 的 查询 ， 例 如 : 


app.store.find('discussions', € 
sort: '+time', 
page: (limit: 5}, 
filter: q: 'test'} 
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find 方法 会 无 条 件 地 发 起 一 个 API 请 求 。 如 果 你 想 要 从 store 的 本 地 缓存 中 获取 model 避 
免 发 起 API 请求 ， 那 就 得 用 getByld 和 all 这 两 个 方法 了 。 例 如 : 


const discussion = app.store.getById('discussions', 1); 
const discussions = app.store.all('discussions'); 


Model 的 属性 和 关系 可 以 用 save 来 存储 到 服务 器 ， 也 可 以 用 delete 来 删除 。 这 两 个 方法 
都 会 返回 一 个 promise。 例 如 : 


discussion.save({ 
title: ' 新 标题 '， 
relationships: { 
tags: [] // Tag model 的 数组 
} 
}); 


discussion.delete(); 


新 的 数据 库 记 录 也 可 以 用 createRecord. 方法 来 创建 。 例 如 : 


const discussion = app.store.createRecord('discussions', { 
title: ' 新 的 主题 ' 
}); 


discussion.save(); 


路 由 
你 可 以 通过 app.routes 来 添加 或 修改 客户 端的 路 由 。 路 由 对 象 的 键 名 是 一 个 唯一 的 名 字 ， 
而 值 则 是 有 path 和 Component 两 个 属性 的 对 象 。 注 意 ， 修 改 路 由 只 能 在 初始 化 的 时 候 完 
JR, o 

app.routes.tag = (path: '/tag/{slug}', component: TagPage.component()); 


你 可 以 用 app.route() 来 生成 一 个 路 由 对 应 的 URL。 例 如 : 


«a href={app.route('tag', {slug: 'blog'})} config={m.route}> 博 客 </a> 


译 者 : @oott123 


` 日 
iod 
Flarum 48 LESS 文件 编译 成 CSS 文件 ， 然 后 担任 客户 端的 一 部 分 ， 关 于 论坛 的 定制 很 容 
易 ， 在 管理 员 面板 外 观 部 分 可 以 通过 点 击 “ 编 辑 自 定 义 CSS" 添 加 你 自己 的 LESS/CSS。 
` `~ > y 
Fa TE IA 


扩展 框架 包含 一 个 空 的 LESs/extension.less 文件 ， 你 可 以 把 任何 自 定义 的 LESS/CSS 样式 
写 入 这 个 文件 。 这 个 文件 使 用 的 是 Buildclientview 事件 注册 : 


use FlarumNEventsNBuildClientView; 


$events->listen(BuildClientView::class, function (BuildClientView $event) { 
$event ->forumAssets([ 
DERM AessAextensaqoniess. 


1); 
3); 


系统 定义 了 许多 LESS 变量 ， 包 括 定 义 主 题 颜 色 和 其 他 。 它 们 被 列 在 variables.less。 当 你 为 
扩展 实现 配色 方案 时 ， 你 应 该 使 用 这 些 变 量 。 


ab 
规 沁 
Flarum 使 用 BEM 风格 命名 CSS 类 。 


.ComponentName-child--modifier 


该 组 件 名 称 组 成 部 分 应 该 与 存在 的 JavaScript 组 件 的 名 称 保持 一 致 。 


模板 


如 果 需 要 ， 您 可 以 使 用 自 定 义 模 板 更 改 论 坛 布 局 。( 默 认 的 位 于 这 里 。) 您 的 自 定 义 模 板 必须 
包含 所 有 相同 的 ID 元 素 。 


use Flarum\Events\BuildClientView; 
use Flarum\Forum\Actions\ClientAction as ForumClientAction; 


$events->listen(BuildClientView::class, function (BuildClientView $event) { 


if ($event->action instanceof ForumClientAction) { 
$event ->view->setLayout(__DIR__.'/../forum.blade.php'); 


3); 


1£4 : @Seevil 
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国际 化 


This page is under construction. 


分 发 


分 发 的 目标 是 使 别人 能 轻松 的 安装 扩展 ， 只 需 把 扩展 放 到 extensions 文件 夹 里 即 可 。 你 不 能 
要 求 他 们 安装 某 种 工具 或 者 编译 什么 代码 一 一 那 是 你 作为 一 个 开发 者 应 该 完成 的 工作 | 


所 以 在 你 打包 扩展 之 前 ， 需 要 安装 好 所 有 的 Compser 依赖 项 ， 并 且 编 译 你 的 JavaScript 42 
序 。 


一 个 打包 脚本 的 示例 : 


#!/usr/bin/env bash 
base=${PWD} 


# Unzip an archive of the latest committed code 

# 解压 Flarum 最 终 版 

rm -rf /tmp/extension-release 

mkdir /tmp/extension-release 

git archive --format zip --worktree-attributes HEAD > /tmp/extension-release/release.z 
ip 

cd /tmp/extension-release 

unzip release.zip -d ./ 

rm release.zip 


# Install all Composer dependencies 

# 安装 Composer 依赖 

cd /tmp/extension-release/flarum 

composer install --prefer-dist --optimize-autoloader --ignore-platform-reqs --no-dev 


# Compile JavaScript 
# 编译 JavaScript 
# Assumes: npm install -g gulp flarum-gulp babel-core 
cd /tmp/extension-release/js 
for app in forum admin; do 
cd "/tmp/extension-release/js/${app}" 
npm link gulp flarum-gulp babel-core 
gulp --production 
rm -rf "/tmp/extension-release/js/${app}/node_modules" 
done 


#4 : @ttnl 
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Introduction 


This page is under construction. 


Packaging 


This page is under construction. 


本 地 化 


翻译 


扩展 框架 包括 一 个 空 的 locale/en.yml 文件 ， 你 可 以 把 你 的 英语 翻译 放 在 这 里 。 键 名 需要 使 
用 snake case 。 他 们 应 该 放 在 和 扩展 名 相同 的 namespace 下 。 翻 译 可 以 包含 
{placeholders} (BR) > 


( 译 者 注 snake case 是 一 种 常见 的 命名 法 ， 他 使 用 下 划 线 来 分 割 每 个 单词 ， 比 如 
register locales ， 通 常用 在 C 语言 或 者 javascript 中 。 对 应 的 还 有 一 种 CamelCase > HZ 
思 义 就 是 驼峰 命名 法 ， Hio Java 中 ， 比 如 RegisterLocales ) 


tags: 
tag_new_discussion_title: Choose Tags for Your Discussion 
edit_discussion_tags_title: "Edit Tags for {title}" 


panes Flarum 的 本 地 管理 器 (locale manager)  RegisterLocales 事件 注册 这 些 语言 
。 扩 展 框架 默认 注册 以 下 语言 包 


use Flarum\Events\RegisterLocales; 


$events->listen(RegisterLocales::class, function (RegisterLocales $event) { 
$event ->addTranslations('en', DERM a localicen tymi ei 


3): 


为 了 使 语言 包 能 被 编译 成 JavaScript 文件 ， 以 便 让 JavaScript 客户 端 调用 ， 它 们 必须 显 式 地 
通过 Buildclientview 事件 注册 。 如 果 你 指定 了 一 个 键 名 ， 它 所 有 的 子 元 素 也 会 被 包括 进 
来 


co 


use FlarumNEventsNBuildClientView; 


$events->listen(BuildClientView::class, function (BuildClientView $event) { 
$event ->forumTranslations([ 
'tags.tag new discussion title', 
'tags.edit discussion tags title' 
1); 
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你 需要 从 网 站 的 assets 目录 里 删除 forum-en-xxxx.js 文件 ， 可 以 强制 性 重新 编译 本 地 的 
JavaScript ° 


翻译 会 调用 客户 端的 app.trans() 方法 : 


app.trans('tags.edit discussion tags title', (title: discussion.title()}); 


复式 规则 


如 果 一 个 count 参数 传递 进来 时 ， 翻 译 器 将 寻找 子 节点 的 多 个 规则 。 黑 认 的 复式 规则 是 英 
语 : 如 果 计 数 为 1， 则 查找 one 键 ， 否 则 查找 other 键 : 


tags: 
choose_primary_tags: 
one: Choose a primary tag 
other: "Choose {count} primary tags" 


app.trans('tags.choose primary tags', {count: 1}); // 'Choose a primary tag' 
app.trans('tags.choose_primary_tags', {count: 7}); // 'Choose 7 primary tags' 


配置 


您 可 以 配置 复式 翻译 系统 的 规则 或 者 其 他 翻译 器 选项 : 通过 给 本 地 化 管理 器 (locale 
manager) 注册 一 个 JavaScript 配置 文件 : 


// locale/en.js 
app.translator.plural = function(count) ( 
return count === 1 ? 'one' : 'other'; 


F; 


// 你 也 可 以 做 一 些 其 它 的 事 ， 比 如 : 配置 moment. js 的 本 地 化 文件 


use Flarum\Events\RegisterLocales; 

$events->listen(RegisterLocales::class, function (RegisterLocales $event) { 
$event->addJsFile('en', _ DIR .'/../../locale/en.js'); 
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Flarum 国际 化 语言 包 https://github.com/justjavac/flarum-i18n-zh 


译 者 : @justjavac 


本 地 化 
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Updating 


This page is under construction. 


Distribution 


This page is under construction. 


